filechooser: Document the settings XML

diff --git a/gtk/org.gtk.Settings.FileChooser.gschema.xml b/gtk/org.gtk.Settings.FileChooser.gschema.xml
index 586881a681f6c0e20ac5ec871b260172911f9604..087b3c221f0811b239ca22a79442bc836c98a7df 100644 (file)
--- a/gtk/org.gtk.Settings.FileChooser.gschema.xml
+++ b/gtk/org.gtk.Settings.FileChooser.gschema.xml
@@ -44,11 +44,19 @@
     </key>
     <key name='location-mode' enum='org.gtk.Settings.FileChooser.LocationMode'>
       <default>'path-bar'</default>
+      <description>
+       Controls whether the file chooser
+       shows just a path bar, or a visible entry for the filename as well, for the
+       benefit of typing-oriented users.  The possible values for these modes
+       are "path-bar" and "filename-entry".
+      </description>
     </key>
     <key name='show-hidden' type='b'>
       <default>false</default>
       <summary>Whether to show hidden files</summary>
-      <description>If set to true, then hidden files are shown by default.  Hidden files are either dotfiles, listed in the folder's .hidden file or backup files ending with a tilde (~).</description>
+      <description>
+       Controls whether the file chooser shows hidden files or not.
+      </description>
     </key>
     <key type="b" name="sort-directories-first">
       <default>false</default>
@@ -57,27 +65,54 @@
     </key>
     <key name='expand-folders' type='b'>
       <default>false</default>
+      <description>This key is deprecated; do not use it.</description>
     </key>
     <key name='show-size-column' type='b'>
       <default>true</default>
+      <description>
+       Controls whether the file chooser shows a column with file
+       sizes.
+      </description>
     </key>
     <key name='sort-column' enum='org.gtk.Settings.FileChooser.SortColumn'>
       <default>'name'</default>
+      <description>
+       Can be one of "name", "modified", or "size".  It controls
+       which of the columns in the file chooser is used for sorting
+       the list of files.
+      </description>
     </key>
     <key name='sort-order' enum='org.gtk.Settings.FileChooser.SortOrder'>
       <default>'ascending'</default>
+      <description>
+       Can be one of the strings "ascending" or "descending".
+      </description>
     </key>
     <key name='window-position' type='(ii)'>
       <default>(-1, -1)</default>
+      <description>
+       Coordinates (x, y) of the upper-left corner of the GtkFileChooserDialog's window.
+      </description>
     </key>
     <key name='window-size' type='(ii)'>
       <default>(-1, -1)</default>
+      <description>
+       Size in pixels (width, height) of the GtkFileChooserDialog's window.
+      </description>
     </key>
     <key name='startup-mode' enum='org.gtk.Settings.FileChooser.StartupMode'>
       <default>'recent'</default>
+      <description>
+       Either "recent" or "cwd"; controls whether the file chooser
+       starts up showing the list of recently-used files, or the
+       contents of the current working directory.
+      </description>
     </key>
     <key name='sidebar-width' type='i'>
       <default>148</default>
+      <description>
+       Width in pixels of the file chooser's places sidebar.
+      </description>
     </key>
   </schema>